home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Original Shareware 1.1
/
The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso
/
16
/
wptools3.zip
/
WPTOOLS3.DOC
< prev
Wrap
Text File
|
1989-03-05
|
51KB
|
1,273 lines
Copyright (c) 1988, 1989 by David Seidman
March 5, 1989
WPTOOLS VERSION 3.0
INTRODUCTION
WPTOOLS Version 3, a shareware product, consists of a what's new
file, this documentation, and thirteen programs: DISKFONT,
FIXPRE, FONTFILE, FONTLIST, LISTMACS, MAKETABS, MERGESUM,
PRINTIT, PRSFONTS, STYLIST, WHATPTRS, WP5LOOK, and WPSNOOP. All
but PRINTIT are utilities for use with WordPerfect Version 5.0
(WP5) files only.
Briefly, this is what the programs do:
DISKFONT Searches a directory for specified soft font files and,
optionally, lists descriptive information about the
fonts it finds.
FIXPRE Removes deleted (and optionally other) data packets from
the prefix of WP5 document files and removes deleted
data packets from WP5 setup files (WP{WP}.SET, or any
other name you have used to store a setup file). For
document files, this will often facilitate changing the
printer driver used with the file and shrink the file.
Setup files grow in size as you modify your setup;
FIXPRE shrinks them again. And FIXPRE sometimes helps
when WP5 just seems to be acting strangely.
FONTFILE Lists the file names of the soft font files specified in
a PRS file.
FONTLIST List the names of the fonts used in a WP5 document.
LISTMACS Lists the names and descriptions of macros in WPM and
WPK files (and the keys for WPK macros), optionally
sorted.
MAKETABS Converts an ASCII text file to a WP5 document, replacing
spaces by tabs.
MERGESUM Creates a WP5 secondary merge file, each record
containing the information from a WP5 document summary
(or, optionally, the first 400 or so characters of a
document if no summary was created), along with
information from the DOS file directory. In effect,
creates a database of document summaries that can be
processed using the WP5 Merge and Sort functions.
PRINTIT Paginates and formats an ASCII text file for printing.
PRSFONTS Lists and optionally numbers the names of the fonts
available in a WP5 PRS file.
STYLIST Lists names and descriptions of styles, optionally sorted.
WHATPTRS Lists the printers described in ALL files, optionally
sorted by printer name.
WP5LOOK Displays one or more WP5 document files specified on the
command line. Particularly because files can be
specified with wildcards, WP5LOOK may be more convenient
than WP5 itself for browsing through WP5 documents.
WPSNOOP Determines, in greater or lesser detail, the file type
of many, but not all, files associated with recent
WordPerfect Corporation products. For document files,
lists the document summary. For macro files, lists the
description. Optionally reveals the structure of WP5
document file prefixes and of WP5 setup file prefixes.
More detail on each program is given below, along with a
description of WP5 document file prefixes.
WPCorp has no connection with these programs, except that it
provided the technical information necessary to write some of
them.
..............................................
Notes on Input and Output
You normally supply these programs with one or more input file
names ("Infile") and sometimes an output file name ("Ofile") on
the DOS command line. The file name may always include drive and
path specifications. The individual program descriptions mention
where wildcards (* and ?) can be used.
Many of these programs are intended to read WP5 files. Wildcards
may cause the program to try to read incorrect file types.
Generally, these programs ignore input files of the wrong kind.
Many of these programs by default write their output to "standard
output," but output will go to a WP5 file instead if you specify
an output file (usually with a -o switch). Sending the output to
standard output can be useful. By default, standard output means
the screen --the output goes to the screen in a continuous flow.
This may not be what you want, either because more than one
screen's worth of output will be generated or because you want to
keep or otherwise use the output. Instead of letting standard
output go directly to the screen, you can pipe it to another
program, or redirect it to either the printer or a file. For
example, screen display is more useful if you pipe output to the
DOS filter MORE:
WPSNOOP *.* |MORE
or, better, to Vernon Buerg's LIST:
WPSNOOP *.* |LIST /s
You might also pipe to PRINTIT and redirect the output from
PRINTIT to the printer directly or to a file for later printing:
WPSNOOP *.* |PRINTIT >prn
or
WPSNOOP *.*|PRINTIT >outfile
Or you can have the program output go directly to an ASCII text
file:
WPSNOOP *.*>outfile
..............................................
I. DISKFONT
DISKFONT has two uses:
1. To provide information about a soft fonts by reading the
soft font disk file.
2. To examine a list of fonts to determine whether their
files are on the disk.
DISKFONT reads a list of soft font file names and searches for
the files in a specified disk directory. By default, it lists
information about the fonts in the soft font files it finds.
Optionally, it merely reports the names of the font files it
fails to find.
FONTFILE (another WPTOOLS program) creates a list of soft font
file names referenced in a PRS file. This list may be used as
input to DISKFONT, which can process the list to find whether the
files are available or to provide more information about them.
Note that the ALL file from which a PRS file was made may
reference more soft fonts than the PRS file references. Soft
fonts are referenced in a PRS file only if you chose to include
them in the PRS file, using * or + (or both). Therefore, the
list generated by FONTFILE may be smaller than the list WPerf is
capable of displaying.
Usage: DISKFONT [-Option] [-Option]
Input is a list of filenames from standard input. The
filenames may include standard DOS wildcards. FONTFILE
output is acceptable input to DISKFONT, and may be piped
to it. If the input is a file containing a list of soft
font file names, use input redirection (<infile). Input
may also come from the keyboard; in that case, use ^Z
followed by Enter to terminate keyboard input.
Output goes to standard output by default and may be
piped or redirected.
Options:
-Ddirectory (Directory where fonts are)
If no directory is supplied, default directory is
assumed. If the input filenames include directory
information, that overrides the command line.
-OOFile For WP5 output.
Formatting of the WP5 file assumes, but does not
set, left and right margins of 1" and a 10-pitch
monospaced font; the tabs set by DISKFONT may
seem strange if those are not your defaults.
-F Only find fonts--no info given
-? Help message
Limitation: DISKFONT has been tested only with font
files compatible with an HP LaserJet Series
II.
Examples:
DISKFONT
Keyboard input, output to standard output (screen).
DISKFONT <myfonts.txt
Input, myfonts.txt, is an ASCII text file containing a
list of font file names. Output to screen.
FONTFILE My.PRS|DISKFONT -Dc:\wp\fonts|PRINTIT>prn
Input is list of font files referenced by My.PRS. The
list is created by FONTFILE and piped to DISKFONT. The
font files are in subdirectory \wp\fonts on drive C:.
DISKFONT output is piped to PRINTIT. PRINTIT output is
redirected to the printer.
Here is an example of the output from DISKFONT:
* * * *
Report for font file AC0060RH.HPF:
FontName Swiss
Typeface 4 (Helvetica)
Orientation Portrait
Height 6.0 points
Style Upright
Font Weight 2
Font type 8-bit
Symbol Set HP Roman-8
Spacing Proportional. Space width is 1.68 points
* * * *
FontName is the name stored in the font file as the name of the
font, although some fonts are usually referred to by a different
name.
Typeface is a number (0-255). For some typefaces, DISKFONT can
supply the typeface name.
Orientation is Portrait or Landscape.
Height is a standard measure of the height of the font. It is
not necessarily the height of any character in the font.
Style is either Upright or what HP calls "italic." HP notes that
other values may be assigned -- DISKFONT will not recognize them.
Weight is the stroke weight of the font, a value from -7 to +7.
According to HP, 0 means "medium," 3 means "bold," and -3 means
"light." DISKFONT translates the numbers to words according to
HP's scheme. Not everyone uses that scheme. BITSTREAM, for
example, apparently treats 2 as meaning bold.
Font Type comes in three varieties. "7-bit" indicates that ASCII
codes 32-127 are printable. "8-bit" indicates that ASCII codes
32-127 and 160-255 are printable. "PC-8" indicates that all
ASCII codes except 0,7-15, and 27 are printable.
Symbol Set indicates which characters will actually print. This
is stored by number in the file. It is possible DISKFONT will
not translate some numbers to words.
Spacing is proportional or fixed. For either, an appropriate
measure of the spacing is listed.
DISKFONT was inspired by Gary Elfring's program FONTINFO.
II. FIXPRE
A. WP5 Document Files
WP5 document files have two sections: the document prefix
(created by WP5), which contains document default settings,
fonts, styles, and similar information; and the document itself
(text and codes entered by the user). More information about
prefixes appears in a separate section below. FIXPRE strips
certain information out of the prefix of a WP5 file; much of the
information stripped concerns printers and fonts, while most of
the rest is obsolete. When you read the stripped file created by
FIXPRE back into WP5, WP5 restores the printer and font
information.
This sounds pretty pointless. Why do it? There are several
reasons:
(1) Some users have had difficulty printing files after changing
printer drivers or when the files were created on another system.
Use FIXPRE to clean the printer-related information out of the
prefix; then read the file into WP5 and install with new drivers.
The difficulties may disappear. (The UPDATE function introduced
in the WP5 July 1988 maintenance release solves many printer
driver problems of this kind, but apparently not all.)
(2) As you edit a file, WP5 adds new information to the prefix
and marks old information as no longer valid. In early releases
of Version 5.0, this led to some problems. Although these
problems may have disappeared with the November 15, 1989 release,
some aspects may remain. This description is based on earlier
releases of WP5. The FASTSAVE option in the WP5 configuration
setup (which is not the default setting with which the program is
shipped) speeds disk saves of documents because it does not
delete from the prefix the old, invalid information. Therefore,
files edited in FASTSAVE mode tend to be larger than other WP5
files, sometimes startlingly so. If you SLOWSAVE a file, most
(but not all) of the outdated information is physically deleted
from the prefix, but not if you FASTSAVE. FIXPRE physically
deletes the information marked as deleted (and, depending on how
you configure FIXPRE, other information as well--the valid
printer and font information, as noted above). So you could
either use SLOWSAVE regularly, or you could use FASTSAVE -- and
FIXPRE from time to time.
(3) Another reason for using FIXPRE is harder to describe.
Sometimes the formatting in a WP5 file goes haywire. The problem
may -- or may not -- go away if you FIXPRE the document. For
example, this document was originally written in WP5, using
Courier 10. I changed to Courier 12, didn't like the results,
and went back to Courier 10. After those changes, centered lines
were no longer centered properly, and many of the tabbed and
indented lines were also off. After trying a few ways of fixing
the problem, I FIXPREd the document and read it back into WP5.
Problem gone. I can't explain why the document went bad, or why
FIXPRE fixed it. But if you run into strange formatting
problems, give FIXPRE a try. Other problems to which this
solution may apply include misplaced graphic lines and improper
font printing.
B. WP5 Setup Files
The WP5 setup file, WP{WP}.SET, also contains a number of data
packets. As you change your setup (without making a new setup
file), new data packets are added and old ones marked as deleted.
WP5 seems never actually to remove these deleted data packets
from the setup file. FIXPRE will remove them. I have seen setup
files shrink to 1/10th their size. WordPerfect Corporation
advises erasing the set file and starting again. FIXPRE is
easier.
C. Using FIXPRE
Usage: FIXPRE Infile [Ofile] [-Option] [-Option]
Infile is the WP5 document or setup file to be fixed.
Ofile is not required. If it is provided, Infile will
be unchanged, and the fixed file written to Ofile. If
you do not provide an Ofile name, Infile will be renamed
(as a backup), and the fixed file will be written under
the original Infile name. The backup file name is based
on the Infile name. It is the main part of the Infile
name, with a new extension. The backup file will NOT
overwrite any existing file. Suppose the Infile you
supply is LETTER.DOC. The program tries to use the name
LETTER.F01 for the backup. If a file with that name
exists, the program tries LETTER.F02, and so on through
F99 (where the program gives up and asks you to provide
an output file name). When the program is finished,
LETTER.DOC will be the fixed file.
Options: (separate multiple options by blanks)
-K Kill (do not preserve) the backup file. The
.Fxx file will be deleted when the program
finishes.
The remaining options are ignored if the input file is a
setup file. Options F and H have no effect if option D
is used.
-F By default, FIXPRE replaces Infile's "document
flags." -F preserves the original document
flags. It is not clear this is ever useful.
-H By default, FIXPRE eliminates the prefix's
"formatter hash table." -H preserves it. It
may never be sensible to use this option.
-D With this option, FIXPRE strips only deleted
data packets from the prefix. If all you want
to do is shrink a file, this option may save a
bit of time.
III. FONTFILE
FONTFILE extracts the list of names of soft font files found in a
PRS file. These files must be present on disk and accessible to
WP5 in order to print documents which use the fonts they contain.
FONTFILE can be used in conjunction with DISKFONT to determine
whether those files are present on disk.
Usage: FONTFILE Infile [Ofile]
Infile should be a PRS file. The file extension
defaults to PRS.
Output goes to standard output, unless Ofile is
supplied. Output can, and often should, be piped to
DISKFONT. See example above. You might also want to
redirect the output to an ASCII text file and then use
the text file as input to DISKFONT when you are
preparing to print a document that uses the PRS file.
If Ofile is supplied, the output is in WP5 format.
Limitation: FONTFILE has been tested only with HP
LaserJet Series II printer files.
IV. FONTLIST
FONTLIST displays a list of the names of the fonts used in a WP5
document file. (This list is found in the document's prefix,
which FONTLIST reads.) This list may be useful if you are not
sure whether the fonts used in a document are available on your
disk.
FONTLIST output can be misleading in two ways. First, the
initial font, or any font specified in a document's initial codes
setting, will appear on the list even if you did not use the
font. (FIXPRE in default mode will delete initial fonts.)
Second, fonts which were once used in a document but later
replaced or removed will also appear in the list. To avoid
listing these fonts, you can use FIXPRE on the document, read the
document into WP5, and then save it. FONTLIST should then
produce a list of fonts actually used in the document (plus the
initial font).
Often, font names in the list will be preceded by an extraneous
character. You should be able to tell by observation that it is
extraneous.
Usage: FONTLIST Infile [Ofile]
Infile is a WP5 document file.
Output is written to standard output unless
Ofile is provided. If Ofile is provided,
output is in WP5 format.
V. LISTMACS
LISTMACS produces a list of up to 1000 macros in its input files;
both WPM and WPK files contain macros (each key redefinition in a
WPK file is a macro). The output includes the file name, macro
description, and, for WPK macros, the name of the key to which
the macro is assigned. By default, the output is sorted by
filename and, within filename, by macro description. Alternate
sorts, or no sort, may be selected as options.
Usage: LISTMACS infile .. [infile] [-oOfile] [-sortoption]
Up to 5 Infiles, which may include wildcards.
Output to standard output unless Ofile specified with
-o. If Ofile specified, output is in WP5 format. WP5
tab settings assume 1" left margin and 10 pitch
monospaced font.
Sort options (default is sort by filename):
-N No sort
-D Sort on macro Description
-K Sort on Key name
Example:
LISTMACS c:\wp\*.wpk c:\wp\*.wpm -D
lists macros in all wpm,wpk files, sorted by description
VI. MAKETABS
MAKETABS converts ASCII text files to WP5 documents, replacing
sequences of spaces by tabs. MAKETABS replaces spaces with tabs
by either of two methods and, in one method, according to either
default tab settings or those the user supplies. The output WP5
file begins with a tab set code if the user supplied a tabstring
or tab spacing information to the program. This form of
conversion is particularly useful for lists and tables, including
the output of some other WPTOOLS programs.
Usage: MAKETABS -OOfile [-Option] [-Option]
-O : output file. Required.
Options:
-IInfile Input filename. If there is no -I option,
MAKETABS defaults to standard input, and input
may be piped or redirected, or it may come
from the keyboard.
-Tn1;n2;..;nmTabstring (in columns of the ASCII input)
-Sn Tab spacing (for equally spaced tabs). In
columns. Default is 5.
-M Use Method 2 (tabs not based on tabstring or
tab spacing)
-Nn MiNimum spaces to replace. Default is 3
-Xn MaX spaces to replace (Method 2). Default is
80.
-Ln WP5 Left margin (inches and tenths). Default
1.0.
Method 1, the default method, replaces spaces by tabs to match
particular tab specifications. Thus a sequence of spaces ending
at the column to which a tab would move the cursor (given the
particular tab specification) is replaced by a tab, but a
sequence of tabs of the same length that fits between two tab
positions is not replaced by tabs.
To use Method 1, MAKETABS requires a tab specification. The tab
specification it uses is always given in terms of column
positions. By default, it uses tabs set at 5 column intervals
(5;10;15;20, etc. -- the limit for a tab specification is column
255). Thus if a line starts with four spaces, they will be
replaced by a tab. If it starts with five spaces, the result
will be a tab followed by a space. If it starts with a letter
followed by three spaces, the spaces will be replaced by a tab.
If it starts with two letters followed by two spaces, by default
the spaces will not be replaced by a tab (because of the default
minimum spaces value of 3 -- you can change that with the -N
option).
You can change the tab specification in two ways. Using the -S
option, you can change the interval from the default value of 5.
Alternatively, you can use the -T option to specify a tab string
completely. That option allows you to set tabs properly to
reflect the pattern of spacing in the file you are converting.
For example, to line up the columns of LISTMACS ASCII output with
tabs rather than spaces, use -T9;15;61 (you would also use -N0,
because there are likely to be some very short sequences of
spaces).
If you do specify tab settings in either of these ways, the
appropriate tab set command is included at the beginning of the
WP5 output file. Column positions are assumed to represent
tenths of an inch. However, the WP5 tab settings are not a
direct translation into inches of your column specification.
MAKETABS assumes that the ASCII text file begins at the beginning
of a line, but that WP5 files have a left margin. By default,
MAKETABS assumes a WP5 left margin of 1.0". So the WP5 tab
settings resulting from the -T command in the previous paragraph
are 1.9", 2.5", and 7.1". You can change the assumed left margin
with the -L command (e.g., -L1.5). MAKETABS does not put a
margin change command in the output file.
Method 2 ignores tab settings entirely. It simply replaces any
sequence of spaces of at least the minimum length (up to the
maximum--see the -X option above) by a single tab.
For an example, see below under WHATPTRS.
VII. MERGESUM
MERGESUM extracts document summaries from WP5 files and writes
them, along with information from the DOS file directory, to a
WP5 secondary merge file. The result is a database of document
summaries. You can then use the WP5 Merge and Sort functions to
manipulate the output.
The secondary merge file MERGESUM creates has the following fields:
1: File path
2: File name (without extension)
3: File extension
4: Creation date (as it appears in the summary)
5: Creation date (yy/mm/dd, for easier sorting)
6: File date (yy/mm/dd) from DOS directory
7: File size (bytes, 7 column field, right justified)
8: Descriptive Filename
9: Subject/Account
10: Author
11: Typist
12: Comments
If, for example, you wanted a report listing, in three columns,
the full file name, the creation date in yy/mm/dd form, and the
Descriptive Filename, you would use a primary merge file like
this:
^F1^^F2^.^F3^[Tab]^F5^[Tab]^F8^
(After the merge output file is created, replace hard page breaks
by hard returns. Or use ^N^P^P at the end of the primary merge
file to avoid hard page breaks.)
By default, the secondary merge file includes no mention of any
WP5 document files included in the input file specifications that
do not have document summaries. However, the filename, file
date, and file size for these files are available. You can also
choose to write this information to standard output. You can
also choose to include records for these files in the secondary
merge file, using just the DOS file directory information or also
including the first roughly 400 characters of the document text
as the "comments."
Usage: MERGESUM Infile [Infile] -oOfile [-A] [-C] [-S]
Any number of Infiles, which may include wildcards.
-oOfile the secondary merge output file
Options:
-A include All WP5 files in Ofile, even if they
have no document summary.
-C like -A, but includes the beginning of the
document text as Comments.
-S information on files with no summaries written
to Standard output.
Note: You can use -S along with -A or -C.
VIII. PRINTIT
PRINTIT has nothing to do with WP5 and, despite its name, does no
printing. It formats ASCII text files for printing. Many of the
programs in WPTOOLS write output to standard output by default.
This output is unpaginated and has no left margin. Sending it
directly to your printer will produce less than ideal results.
PRINTIT reads standard input, paginates it, puts a heading on
each page (the heading has the date and a page number, and
optionally includes a title), and writes it to standard output.
It does not insert any printer control codes in the output file -
- pages are filled with blank lines where necessary. By default,
it provides no left margin, assumes the page length is 66 lines,
and puts 60 lines of text on the page. You can specify a left
margin on the command line, and you can clone the program to
change the default left margin, the page length, and the last
printing line. The default page length and bottom line are
probably suitable for most printers. For printers such as the HP
LaserJet, you will want to clone the program to change the number
of lines of text on a page.
PRINTIT does NOT write anything to the printer. It writes to
standard output. You can redirect its output to the printer, or
you can redirect its output to a file and copy the file to the
printer.
Usage: PRINTIT ["title"] [-Option]
Input from standard input
Output to standard output
Title appears on each page of the output.
Enclose the title in double (") or single ( ',
but NOT ` ) if it contains blanks. If the
title includes one kind of quotation mark, use
the other to enclose it.
Options:
-? Help
-n n is a digit,0-9, the number of
columns to offset the output from the
left edge.
-C Clone for page length, bottom line,
offset (number of blank columns to
insert before the text).
Cloning is fully prompted -- simply follow the
directions. Cloning overwrites the executable
file with a modified version (and so the
program file may have a later date than you
would expect). If you use DOS 2.x, you must
have PRINTIT.EXE in the default directory. If
you use DOS 3.x, PRINTIT will find itself
under whatever name you use for it. If you
use DOS 4.x, let me know what happens.
PRINTIT is based on code in Software Tools in Pascal, by
Kernighan and Plauger. The cloning routine is David Doty's
WritExec, which is based on David Dubois' AutoInst. Because of
the origins of the program, it is not subject to the limitations
of the WPTOOLS license provisions. Anyone may use PRINTIT
without paying the WPTOOLS license fee.
IX. PRSFONTS
PRSFONTS lists the fonts available in a WP5 PRS file. This is
useful if you have a laser printer and create numerous PRS files.
PRSFONTS can number the list, starting with zero. These numbers
are the basis for the ID numbers you must supply to an HP
LaserJet Series II printer if you download soft fonts from the
DOS command line, rather than relying on WP5 to download them.
Whether these numbers are suitable for other printers has not
been tested.
Usage: PRSFONTS Infile [Ofile] [-N]
Infile is a WP5 PRS file. If no extension is
supplied, extension PRS is assumed.
Output is written to standard output unless
Ofile is specified. If it is specified,
output is in WP5 format.
-N Number the fonts.
X. STYLIST
STYLIST produces a list of up to 1000 styles in document files
and style libraries. The list includes the filename, the name of
the style, the letter P (for paired) or the letter O (for open)
to indicate the type of style, and the style description. By
default, the output is sorted by filename and within filename by
style name. Other sorting options are available.
Usage: STYLIST Infile [Infile] [-oOfile] [-sortoption]
Up to 5 Infiles may include drive, directory,
wildcards.
Output to standard output, unless Ofile is
specified (with -o). If Ofile specified,
output is in WP5 format. WP5 formatting sets
left and right margins to 0.5". Tab settings
based on assumption of 10 pitch monospaced
font.
Sort options (default is sort by filename):
-N No sort
-D Sort on style Description
-M Sort on style naMe
-T Sort on style Type (Paired, Open)
Example: STYLIST c:\wp\*.sty c:\wp\*.doc -D
lists styles in all sty and doc files, sorted by description
XI. WHATPTRS
A single ALL file can be used to create PRS files for a number of
different printers. WHATPTRS lists the printers for which the
input ALL file can create drivers. Each line of the output
begins with the name of the input ALL file, followed by the name
of a printer. The program can usually sort by printer name.
Whether WHATPTRS can sort all the printer names depends on how
many printers there are in the input ALL files and on the amount
of memory available. If you cannot sort the full collection with
WHATPTRS itself, you could pipe unsorted output to the DOS SORT
routine. The WHATPTRS sort is not sensitive to case; because the
DOS sort is sensitive to case, the -L option is available to put
printer names into all lower case. Some printer names in ALL
files begin with *, to indicate that the source of the printer
information in the file is not WordPerfect Corporation. To
permit a proper sort, WHATPTRS moves the * from the beginning to
the end of the printer name.
Usage: WHATPTRS Infile[.ext] [Ofile] [-option] [-option]
Infile may include wildcards. ext defaults to
ALL.
Output to standard output unless Ofile is
specified. If Ofile is specified, output is in
WP5 format.
-S Sort output by printer name.
-L output Lower case printer names.
Examples WHATPTRS *|PRINTIT>prn
Prints a list of printers in all the ALL files
in the default directory.
WHATPTRS * -L|Sort/+15|MAKETABS -OutFile -M
Produces (in OutFile) an alphabetically sorted
list of printers in all the ALL files in the
default directory, in the form of a WP5 file
formatted with tabs rather than spaces. You
can get the same results with
WHATPTRS * OutFile -S -L
WHATPTRS * -L|find "panasonic" >prn
Prints the names of all Panasonic printers in
the ALL files in the default directory,
together with the name of the ALL file
applicable to each printer.
XII. WP5LOOK
WP5LOOK is a file browsing program for WP5 document files. It
displays WP5 document files listed on the command line. (The
document summary is displayed if it exists.) The program pauses
as each screen is displayed. If there is more information in the
document, you can page forward. Generally, you can also page
backward within a document, although only for a few screens (the
number varies, but is never more than eight). At each screen,
you also have the options of going back to the beginning of the
file (Home), jumping to the end of the file, going on to the next
file, or quitting the program. (If there are no more files, the
next file and quit options produce the same results.) You can
also search for strings in the displayed file. The top line of
the display indicates the corresponding WordPerfect page numbers.
WP5LOOK does not correctly format files, but its display will
typically be a reasonable approximation of the proper formatting.
The program is designed for use when you need to rummage through
one or more WP5 documents quickly (or when not enough memory is
available to use WP5 itself), not for when you care about the
details of formatting. Here are some of the formatting problems:
-- Paragraphs are reformatted by default to a 75-character
line, although you can change the number from 75; the
right margin is especially ragged, because words are not
split at hyphens. Margin changes are ignored. Line
spacing is ignored. Multiple columns are placed end to
end.
-- Everything is displayed in the same font.
-- Tab settings are ignored. Ordinary tabs are displayed
as five spaces, more exotic tabs as a single space.
Indent codes are all treated as ordinary, not left-
right. An indent code is represented as five spaces.
Indented text is indented five spaces.
-- Centering is based on an 80-character line.
-- Characters a standard IBM PC cannot display and
overstruck characters are displayed as upsidedown
question marks.
-- Footnotes and endnotes are displayed embedded in the
text where they occur. They are set off by line breaks
and enclosed between **FN: and **EFN.
-- Styles, initial codes, graphics, captions, and so forth
are ignored.
Usage: WP5LOOK Infile [Infile] .. [Infile]
Infile may include wildcards. You may specify as many
Infiles as fit on the command line.
Once you have started the program, operation is prompted and for
the most part intuitive. The bottom line on the screen indicates
which keystroke options may be chosen (except for W, which is
never indicated). In some cases, you can use different
keystrokes to achieve the same result. The prompt does not
indicate that flexibility. Here is the full set of options, only
some of which may be available at particular screens:
Move one screen forward PgD, [space], [return]
To last screen in file [End]
Move one screen back PgU, b, B
To first screen in file [Home]
To next file N
Exit from the program Q, [esc], F7
Search (exact match) S
Find (match ignoring case) F
Set line Width, 10-80 chars. W
Search and Find
When you select Search or Find, you are prompted for a search
string. Search looks for an exact match to your search string.
Find looks for a match but ignores differences in case.
(Searching for cat will not match CAT, but Finding cat will match
CAT.) If you have previously done a Search or Find in the same
WP5LOOK session, you will be shown your previous search string.
If you want to use the same search string, simply hit <enter>.
You can also edit the search string. If the first keystroke you
hit is a character rather than an editing key, the previous
search string will disappear, and you simply enter (and edit) a
new one.
Searching and Finding search from the currently displayed screen
to the end of the file. The first screen containing a match is
displayed, with each line containing the match highlighted.
After each match, you are asked whether you want to continue
looking for the same string. To search the entire file, you must
start the search at the beginning of the file (which you can
reach with the Home key).
Leading and trailing blanks in the search string can be used if
you want to limit searches to matching whole words. For this
purpose, screen display lines of your WP5 document file are
treated as beginning and ending with blanks. The search string
may include blanks, so you can search for phrases (limited to 60
characters). However, matches are limited to a single line -- if
a phrase is split between lines in the display, you cannot match
it.
The search string can be edited using the cursor keys and other
keys in an intuitively obvious manner. WordStar editing commands
are also available. A complete list of editing commands follows
(commas indicate alternatives):
<Enter> (<Return>) Accept line
<Esc> Quit without changing line; do not search
<Left>,<CtrlS> Cursor left one character
<Right>,<CtrlD> Cursor right one character
<CtrlLeft>,<CtrlA> Cursor left one word
<CtrlRight>,<CtrlF> Cursor right one word
<Home>,<CtrlQ><S> Cursor to line beginning
<End>,<CtrlQ><D> Cursor to line end
<Del>,<CtrlG> Delete character at cursor
<Bksp>,<CtrlH>, Delete character to left of cursor
<CtrlBksp>
<CtrlEnd>,<CtrlQ><Y> Delete to end of line]
<CtrlY>, <CtrlX> Delete entire line
<CtrlHome> Delete from beginning of line
<CtrlT> Delete word to right of cursor
<Ins> Toggle insert mode on or off. Size of
cursor indicates the mode. Default is
insert mode off.
<CtrlR>,<CtrlQ><L> Restore original contents of line after
editing
XIII. WPSNOOP
WPSNOOP displays information concerning its input file(s). If
WPSNOOP recognizes an input file as a WPCorp-type file, it at
least identifies the WPCorp product to which the file is related.
If the file is recognized as a WordPerfect file (and it is not
for versions earlier than 5.0), WPSNOOP reports on the type of
file. If the file is a WP5 document file, WPSNOOP lists the
document summary if one exists. If the file is a WP5 macro file,
WPSNOOP lists the macro description. Used with a wildcard input
file specification, WPSNOOP can therefore provide useful
identification for many of the files.
For WP5 document files and setup files, WPSNOOP optionally
provides considerably more information, although most WP5 users
will not find this information useful. For a WP5 document file,
WPSNOOP can display information about the file prefix -- in
particular what sort of data packets are contained within the
prefix, where they are located and how large they are. (Data
packets are part of the organizational structure of the file
prefix; the term data packet comes directly from WPCorp.)
Similar information can be shown for a setup file.
Usage: WPSNOOP infile [infile] [-oOfile [-V]
Up to 5 infiles, which may include
wildcards.
Output is written to standard output, unless
Ofile is specified (with -o). If Ofile is
specified, output is in WP5 format.
-V option for Verbose report, which
includes full map of data packets.
Limitations:
With the Verbose option, WPSNOOP may not provide information
about a few indexes which technically exist but provide no
information. The end of useful information is signalled
(generally) by an index identifying a data packet of the "end of
prefix" type. All data packets after the first such data packet
are identical (or at least provide no useful information).
WPSNOOP reports on only the first of these, even though others
may exist. If the index pointing to the "end of prefix" data
packet has an index number less than 4, enough additional
identical indexes exist so that the last of them is No. 4.
GENERAL INFORMATION ABOUT WP5 FILE PREFIXES
This section provides some basic information about WP5 file
prefixes. Although this information may help you understand the
situations in which FIXPRE is likely to be useful, you do not
need to read this section in order to use FIXPRE, and the less
technically inclined might wish to skip it.
A WP5 file document file has two areas: the prefix area and the
document area. The document area contains, roughly speaking, the
keystrokes you put into the file; it corresponds to the entire
file in earlier versions of WordPerfect, which did not use
prefixes.
The prefix area begins with a "file prefix," which identifies the
file as a WP5 file, indicates where the document area begins (as
an offset in the file), and does little more.
The rest of the prefix area consists of "data packets" (which
contain a wide variety of information about printers, defaults,
fonts, graphics, styles, and other matters) and indexes (which
identify where in the prefix particular data packets are
located).
The indexes are organized in blocks. Each block consists of a
"header index" and four other indexes. The header index
identifies itself as such, provides some information which is the
same for every WP5 document file header index and is therefore
not interesting, and gives the offset in the file where the next
index block begins. Each of the other four indexes in a block
identifies the type of data packet to which it is an index, the
length of that data packet in bytes, and the offset in the file
where the data packet can be found.
WP5 document files can have the following kinds of data packets,
as well as some that published information has apparently not yet
identified:
Document summary
Document default values
Document flags
Font name string pool
Graphic image data
Formatter hash table
List of fonts used in document
Document printer information
Style
PS tables for fonts
In addition, there may be deleted packets.
The structure of a WP5 setup file is identical to that of a WP5
document file prefix, except that it has a different set of data
packets.
UPDATE NOTES
WPTOOLS Version 3 differs from Version 2 in a number of respects.
(1) Two new programs, MERGESUM and WP5LOOK, have been added.
(2) PRSFONTS has been modified to limit its output to the actual
fonts where possible and to allow numbering of the fonts. The
50,000 character limit on the list of fonts has been reduced by
3,000. (3) FONTLIST has been modified so that it will work
correctly with some files that it did not properly handle before.
(4) WHATPTRS now can itself sort the printer list; it also moves
the position of an asterisk WPCorp added to some printer names.
One of the two formats for output has been deleted. (5) A
number of the programs, which previously sent output only to
standard output, now optionally write WP5 format output. (6)
FIXPRE has been modified to allow more convenient operation.
Progress comes at a price. The registration fee for WPTOOLS3 is
$5 greater than for WPTOOLS2.
David Seidman
Software by Seidman
2737 Devonshire Pl. NW
Washington, DC 20008
CompuServe: [70441,2414]
* * * * * * * * * * * * * * *
LICENSE INFORMATION
WPTOOLS3 is not in the public domain. Both the collection and
the individual programs are fully protected by copyright.
You are granted without charge a license which permits (a) use of
the programs for a period of 30 days for evaluation and testing;
(b) making copies for distribution to others without charge,
provided the programs and the accompanying documentation are
distributed together and without modification; (c) posting the
programs, together with the accompanying documentation, on
electronic bulletin board systems. (For PRINTIT only, you are
granted without charge a license to use the program for as long
as you like.)
Use after the 30 day evaluation and testing period requires
payment of a license fee. For a single copy (plus necessary
archival copies), to be used on only one computer at a time, the
fee is $25.00. For your convenience, an invoice form is included
below. For large quantities, discounts and site licenses are
available. Write for information. Any license for which payment
is properly made is valid for this version of WPTOOLS and all
subsequent versions.
What do you get for your license fee? Aside from permission to
use the programs and the warm feeling that you are not violating
the copyright laws, not very much, but a little. If you pay the
license fee to me and tell me the version you have (or if I can
figure out what version you have), I will send you the next
version (unless the next version involves a trivial change too
small to worry you about). After that, I will send you
notification of further new versions. And if you let me know
about any problems you have with the programs, I will try to
solve them.
Users groups and other not-for-profit organizations may
distribute unmodified copies of WPTOOLS3, together with its
accompanying documentation, for a fee to cover duplication and
related costs, but not to exceed $6.00. Your payment of such a
fee does not eliminate the requirements concerning payment of a
license fee. Certain organizations may have been granted
permission to distribute the program for a fee larger than $6.00,
the larger fee to include the license fee for a single copy. If
the organization from which you received a copy of the program
has been granted that permission, it should tell you so.
The United States Department of Justice is granted a license,
without payment of fee, for all official use of WPTOOLS3.
WARRANTY INFORMATION
These programs are distributed without warranties of any kind,
express or implied, including, but not limited to, the implied
warranties of merchantability and fitness for a particular
purpose.
No representation or other affirmation of fact, including but not
limited to statements regarding suitability for use, or
performance of the programs, shall be or be deemed a warranty by
the licensor for any purpose, nor give rise to any liability or
obligation of the licensor whatever.
In particular, no statement in program documentation shall be
deemed a representation or warranty that the programs will
perform in any particular manner, or perform in any manner
whatsoever, or that the programs are suitable for any particular
use or any use at all.
* * * * * * * * * * * * * * *
INVOICE
David Seidman
Software by Seidman
2737 Devonshire Pl. NW
Washington, DC 20008
DATE:
SOLD TO:
__________________________
__________________________
_________________________
┌──────────────────────────────────────┬────────────────────────┐
│ Description │ Price │
│ │ │
├──────────────────────────────────────┼────────────────────────┤
│ │ │
│ License for WPTOOLS3.1 │ $ 25.00 │
│ │ │
│ additional licenses @ $25.00 │ _____.__ │
│ │ │
│ │ │
│ │ │
│ │ │
└──────────────────────────────────────┴────────────────────────┘
Total: $_____.__
D.C. Residents add 6% D.C. Sales Tax: ___.__
Total Charge: $_____.__
Make checks payable to David Seidman. Please mark checks
"WPTOOLS31".
------------------------------------------------------------